package com.joker.airoleplayplatformback.service;

import com.joker.airoleplayplatformback.domain.po.KnowledgeBasePO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 知识库服务接口
 * @author feixiang.li
 * @since 2025-09-28
 */
public interface KnowledgeBaseService {

    /**
     * 上传文档到知识库
     *
     * @param userId      用户ID
     * @param name        用户名称
     * @param description 描述
     * @param file        文件
     * @return 知识库记录
     */
    KnowledgeBasePO uploadDocument(Long userId, String name, String description, MultipartFile file);


    /**
     * 搜索知识库
     *
     * @param userId 用户ID
     * @param query  查询
     * @return 结果
     */
    List<String> search(Long userId, String query);

    /**
     * 上传文本到知识库
     */
    KnowledgeBasePO uploadText(Long userId, String name, String description, String content);

    /**
     * 获取用户的知识库列表
     */
    List<KnowledgeBasePO> getUserKnowledgeBases(Long userId);

    /**
     * 根据ID获取知识库详情
     */
    KnowledgeBasePO getKnowledgeBaseById(Long id);

    /**
     * 删除知识库
     */
    boolean deleteKnowledgeBase(Long id, Long userId);

    /**
     * 更新知识库
     */
    KnowledgeBasePO updateKnowledgeBase(KnowledgeBasePO knowledgeBasePO);
}
